home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 051-075 / scopedisk55 / dirk2 / dirk.doc < prev    next >
Text File  |  1995-03-18  |  8KB  |  212 lines
  1.  
  2.     1/89
  3.  
  4.  
  5.     DIRK v2.0 -- Tune workbench colors to system performance
  6.  
  7.                          -----------------
  8.  
  9.                    Copyright (C) 1989 by Daniel Elbaum
  10.  
  11.          This software is freely redistributable provided that:
  12.          the four files which comprise it (dirk, dirk.doc, dirk.h,
  13.          adjust.c, main.c, sys, window.c) remain intact; all
  14.          copyright notices contained in any of the aforementioned
  15.          files remain intact; and no fee beyond reasonable remuneration
  16.          for collation and distribution be charged for use and/or
  17.          distribution.
  18.  
  19.                          -----------------
  20.  
  21. New Features:
  22.  
  23.     Pressing the right mouse button while the `Dirk' tinywindow
  24.     is active will now expand the window, presenting numerical
  25.     displays of the information Dirk uses.  Clicking the right
  26.     button again while that window is selected will shrink the
  27.     window back to a tinywindow.  Thanks to Steve Tibbett for
  28.     the idea (from later versions of VirusX).
  29.  
  30.     While either the tinywindow or the display window is active,
  31.     Dirk will update constantly.  Just select any other window
  32.     to reinstate the timing interval.
  33.  
  34.     The '-bN' option (background intensity) has been replaced with
  35.     six new optional arguments: three sets of color intensities
  36.     which determine the color of the screen when memory is full
  37.     and empty; at other times, the screen color is taken from an
  38.     interpolation between the two.  See the '-erN ...' and '-frN'
  39.     discussions.  Basically, you specify red, green, and blue
  40.     intensities for the case wherein all memory is free and for
  41.     the case wherein all memory is allocated.
  42.  
  43.     The default detail pen color is now a faint yellow, which
  44.     provides better contrast with a wider range of backgrounds.
  45.  
  46.     The detail pen color arguments (+rN, +gN, +bN) must now be
  47.     preceded with the letter 'd', and the '-' is used instead
  48.     of the '+' to introduce arguments: -drN, -dgN, -dbN.
  49.  
  50.                          -----------------
  51.  
  52. Syntax:
  53.     run Dirk [-t|m] [-gN] [-hN] [-lN] [-iN]]
  54.         [-drN] [-dgN] [-dbN] [-erN] [-egN] [-ebN] [-frN] [-fgN] [-fbN]
  55.  
  56.                          -----------------
  57.  
  58. Parameters:
  59.  
  60.     Option   Default    Effect
  61.     ---------------------------------------------------------------------
  62.         t               track tasks only
  63.         m               track memory only
  64.         g        4      granularity of task mapping (small for few tasks)
  65.         h       12      maximum detail intensity
  66.         l        8      minimum detail intensity
  67.         i      180      interval in ticks (60 or 50 per second)
  68.  
  69.         dr       2      tweak value for red component of detail pen
  70.         dg       2      tweak value for green component of detail pen
  71.         db       0      tweak value for blue component of detail pen
  72.         er       0      amount of red when memory is empty
  73.         eg       0      amount of green when memory is empty
  74.         eb      14      amount of blue when memory is empty
  75.         fr      14      amount of red when memory is full
  76.         fg       0      amount of green when memory is full
  77.         fb       0      amount of blue when memory is full
  78.  
  79.     If you like the program, you may eventually want to start it
  80.     from your startup-sequence, so you might want to dirk around
  81.     with the options before deciding on a command line to use.
  82.  
  83.     My startup-sequence uses this line:
  84.  
  85.         arun dirk -fr12 -er0 -fb0 -eb12 -i20 -h11 pri -5
  86.  
  87.     where `arun' is the ARP version of Run, which would work just
  88.     as well, but for which one would discard the `pri -5' part.
  89.  
  90.  
  91.     Here are all the options explained.
  92.  
  93.     The -t option enables task tracking only.  The background color
  94.     is not affected.
  95.  
  96.     The -m option complements the -t option; only memory tracking is
  97.     turned on.  The detail pen color is not affected.
  98.  
  99.  
  100.  
  101.     The following command line options require counts.  The valid
  102.     range of the count varies from option to option.  All color
  103.     counts should be between 0 and 15; other counts must be
  104.     between 0 and 65535.
  105.  
  106.     Granularity, set with -gN, is the sensitivity with which detail
  107.     pen color responds to the instantaneous number of ready tasks.
  108.     Workable values lie between 1 and 8.
  109.  
  110.     Maximum detail intensity (-hN) is a limit on the brightness of
  111.     the detail pen.  A value of 8 to 14 (14 brighter) can keep
  112.     detail from glaring.  The valid range is 0-15.
  113.  
  114.     Minimum detail intensity -lN (ell not one) is a floor on the
  115.     brightness of the pen, to maintain good contrast to the
  116.     background.  For a light background, l should be at least 8.
  117.  
  118.     The interval (-iN) is the number of ticks to wait between
  119.     data retrieval expeditions.  A tick is 1/60th of a second
  120.     in the US, and 1/50 in Europe.  If N is given as 0, the
  121.     research and reporting are done constantly, and system
  122.     performance slows slightly but noticeably.  180 corresponds
  123.     to ~3 seconds, and is probably a good functional maximum.
  124.  
  125.     The -d arguments specify the detail pen colors.
  126.     As the number of tasks increases, the pen becomes dimmer,
  127.     and as the proportion of active tasks increases, the pen
  128.     becomes yellower.  -drN sets the red component (0-15),
  129.     -dgN sets the green, and -dbN sets the blue.  It's worth
  130.     experimenting to find a combination which provides good
  131.     contrast.
  132.  
  133.     The -e and -f arguments specify the colors at the ends
  134.     of the spectrum.  Values specified with -erN, -egN, and
  135.     -ebN determine the color of the screen when virtually
  136.     no memory is allocated, and values specified with -frN,
  137.     -fgN, and -fbN determine the screen color when memory
  138.     is full.  The greater the difference between the two,
  139.     the finer the correlation between screen shade and memory
  140.     usage.  The defaults (-er0, -eg0, -eb14, -fr14, -fg0, -fb0)
  141.     cause the screen hue to range from blue (no memory in use)
  142.     to red (all memory allocated).
  143.  
  144.     It all sounds confusing but once you run the program
  145.     and see what it does, the meanings of the command line
  146.     options will no doubt fall into place.
  147.  
  148.                          -----------------
  149.  
  150. Description:
  151.  
  152.     The purpose of this program is to present key system
  153.     information to the user without cluttering up the display.
  154.     The workbench background color changes from blue through
  155.     purple to red as the amount of free memory decreases.
  156.     The workbench detail color (the color of text and Workbench
  157.     window borders) changes from bright white to gray as the
  158.     number of system tasks increases.  Further, the yellow
  159.     content of this color is increased according to the number
  160.     of active tasks.
  161.  
  162.     On a newly-booted vanilla system, borders are white and the
  163.     background is close to the standard Workbench blue.  As
  164.     you use the system, calling up programs and creating files
  165.     on the RAMdisk, the screen takes on an increasingly reddish
  166.     hue.  When memory is nearly full, the background is completely
  167.     red.
  168.  
  169.     Similarly, as tasks are added, the borders and text dim
  170.     slightly.  In other words, after you set up dmouse, conman,
  171.     snipit, or whatever to run in the background, the detail color
  172.     fades, eventually to grey.  If many background tasks are
  173.     active rather than just waiting around for an interrupt or
  174.     message, the grey will be tinted yellow.
  175.  
  176.     With Dirk running in the background, you always have a rough
  177.     idea of how much memory is available and how busy the system
  178.     is, without hunting around for the window of your favorite
  179.     resource-tracking gizmo.  If you need more precise information,
  180.     just select the Dirk window and press the right mouse button.
  181.  
  182.                          -----------------
  183.  
  184. Bugs:
  185.     Nary a one, I declare.  Dirk won't function properly if
  186.     your workbench screen is fewer than 115 pixels tall.  But
  187.     then, not many programs will.
  188.  
  189.                          -----------------
  190.  
  191. Signature and self-promo:
  192.  
  193.     If you want to send me money for Dirk, then by all means
  194.     do so--many projects are in progress and I need financing.
  195.     $5.00 is recommended.  Make checks payable to:
  196.  
  197.     Daniel Elbaum
  198.     4816 SE Bybee Blvd.
  199.     Portland, Ore. 97206
  200.  
  201.  
  202.     Send comments, suggestions, and unmitigated praise to:
  203.  
  204.     Daniel Elbaum
  205.     Portland bbs: Amigaboard!, NAG
  206.     UUCP: ...!tektronix!reed!elbaum
  207.     ARPA: elbaum@reed.EDU
  208.  
  209.  
  210.  
  211.  
  212.